ALIEN ARMAGEDDON 1.0
Released August 24th 2018
Version 2.0 released February 16, 2019
update 2.02 released February 17, 2019
update 2.10 released March 1, 2019

Alien Armageddon is a overhaul of Duke Nukem 3D which runs on the EDuke32 platform. This document contains some simple instructions for getting the game started. Credits and other information about the game can be seen within the game. Additional credits can be found in AA Credits.rtf

To install and run:

Unpack the folder alien_armageddon from the DNAA210.zip file. 

Place a copy of the file 'DUKE3D.GRP' (the game data from Duke Nukem 3D) inside of the alien_armageddon folder at root level. An Atomic Edition or later version of the file is required (not shareware, not version 1.3, etc.) Note: Eduke32 will look for your DUKE3D.GRP data file in several places, so if Duke 3D is installed elsewhere on your system, you may not need to copy it to the install folder.

Run eduke_64bit.exe OR eduke_32bit.exe to start the game, as appropriate for your system. 

New option as of version 2.10 -- we have supplied upscaled enemy sprites as an optional extra, and to see them you need to start the game using the included AA_UPSCALE.BAT

On the video mode dropdown menu, it is recommended to use OpenGL for the full visual experience, but the game will work in the software renderer.

It is NOT recommended to check the box for "Polymer". The Polymer renderer is not fully commpatible with Alien Armageddon; you will experience low framerate, missing shadows and missing voxels. The only advantage to using Polymer is that it renders dynamic lights from projectiles, fires, and certain other sprites.

The included executables have been tested with this version of Alien Armageddon. If you use an executable from an older OR newer version of Eduke32, then do so at your own risk. If you want to try other builds of EDuke32, you can find them here:
 
http://dukeworld.duke4.net/eduke32/synthesis/
Mac builds of Eduke32 can be found here: http://dukeworld.duke4.net/eduke32/mac/

As with any mouse and keyboard shooter, you should configure the mouse and keyboard to your liking. Alien Armageddon uses three functions different from regular Duke 3D: 

SWAP CHARACTERS 
SECONDARY FIRE
ALTERNATE WEAPON

You should assign each of those to suitable keys or buttons from the setup menu before starting a game. SWAP CHARACTERS will switch control of the playable character, if the other character is available. SECONDARY FIRE will activate the secondary function of the weapon currently selected, if the weapon has a secondary function (for example, reload weapon or use scope). ALTERNATIVE WEAPON will switch to a subweapon on the same weapon slot, if one is available (for example, it will switch between shrinker and expander). Additionally, on Bombshell's SMG, it will cause the weapon to reload. You can also access subweapons by using the next/previous weapon keys.

A note about the "censoredtiles" folder. This folder contains alternative versions of the .ART files with less explicit sexual content. If you are a streamer who serves a general audience, or just a player who wants less sexual content in the game, replace the .ART tiles at the root with the ones in the censoredtiles folder. Don't forget to make a backup of the originals if you want them later!

Troubleshooting:

If you own Duke Nukem 3D but you get an error message that "DUKE3D.GRP" cannot be found, or something similar, then you need to find the file "DUKE3D.GRP" and place a copy of it within the alien_armageddon folder where the executable resides.

Questions or comments, or bug reports? Go to https://www.moddb.com/mods/duke-nukem-alien-armageddon and post there. You can also find me at duke4.net forums, where I go by the name "Trooper Dan". Obviously, any information contained in this readme could be invalidated by future events.

Dan "DeeperThought" Gaskill
August 23, 2018
Updated March 1, 2019